Inside Macintosh: QuickTime Components /

Chapter 9 - Movie Data Exchange Components / Movie Data Exchange Components Reference

Exporting Movie Data /

MovieExportToFile

The MovieExportToFile function allows the Movie Toolbox to export data to a file, using your movie data export component.

pascal ComponentResult MovieExportToFile (ComponentInstance ci,
                                           const FSSpec *theFile,
                                           Movie theMovie, 
                                           Track onlyThisTrack,
                                           TimeValue startTime,
                                           TimeValue duration);

ci

Identifies the Movie Toolbox's connection to your movie data import component.

theFile

Contains a pointer to the file that is to receive the converted movie data. This file's type value corresponds to your component's subtype value.

theMovie

Identifies the movie for this operation. This movie identifier is supplied by the Movie Toolbox. Your component may use this identifier to obtain sample data from the movie or to obtain information about the movie.

onlyThisTrack

Identifies a track that is to be converted. This track identifier is supplied by the Movie Toolbox. If this parameter contains a track identifier, your component must convert only the specified track.

startTime

Specifies the starting point of the track or movie segment to be converted. This time value is expressed in the movie's time coordinate system.

duration

Specifies the duration of the track or movie segment to be converted. This duration value is expressed in the movie's time coordinate system.

DESCRIPTION

The Movie Toolbox calls the MovieExportToFile function in order to export movie data into a file. Your component must read the data from the track or movie, perform appropriate conversions on that data, and place the data into the specified file. The file's type corresponds to the component subtype of your movie data export component.

Note that the requesting program or toolbox must create the destination file before calling this function. Furthermore, your component may not destroy any data in the destination file. If you cannot add data to the specified file, return an appropriate error.

If your component can write data to a file, be sure to set the canMovieExportFiles flag in your component's componentFlags field.

Your component must be prepared to perform this function at any time. You should not expect that any of your component's configuration functions will be called first.

RESULT CODES

invalidTrack

-2009

Specified track cannot be converted

Other appropriate Movie Toolbox result codes

SEE ALSO

The Movie Toolbox uses the MovieExportToHandle function to export data to a file; this function is described in the previous section.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help